home *** CD-ROM | disk | FTP | other *** search
/ Amiga Inside! / Amiga FD Inside (1995)(Ultramax).iso / berndspd / musiktools / superplay / docs / superplay-lib_eng.doc < prev    next >
Text File  |  1994-12-13  |  8KB  |  253 lines
  1.  
  2.                       superplay.library V4.3
  3.  
  4.                            - FREEWARE -
  5.  
  6.              © 1994 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.               This program was written under OS V3.1 and is therefore
  9.               fully compatible. It needs OS V2.04+.
  10.  
  11.               Release Date : 13.12.1994
  12.  
  13.  
  14.     Copyright :
  15.     ===========
  16.  
  17.     The program superplay.library V4.3 and its documentation files are
  18.     (C)opyright 1994 by Andreas R. Kleinert. All rights reserved.
  19.  
  20.     The usage of the "superplay.library" for own program projects, no
  21.     matter if commercial or non-commercial, is allowed without any
  22.     restrictions.
  23.  
  24.  
  25.     Disclaimer :
  26.     ============
  27.  
  28.     The author takes no responsibility for any results of the use of this
  29.     program.
  30.     This software is provided "AS IS" and there is no warranty of any kind,
  31.     so that you use this software at your own risk.
  32.  
  33.  
  34.     Functions :
  35.     ===========
  36.  
  37.     The "superplay.library" is used in many of my programs and it consists of
  38.     many functions, which make playing, saving and converting of various
  39.     sound formats (SoundTracker, MED, IFF-8SVX, VOC, ...) much easier.
  40.     External Player-Libraries (SPObjects) allow highest possible
  41.     flexibility and easy to do expansions.
  42.  
  43.     Just send me your own SPObjects if you want to have them added
  44.     to the main distribution archive or onto the developer disk.
  45.  
  46.  
  47.     Installation :
  48.     ==============
  49.  
  50.     Just copy the "superplay.library" into your "LIBS:"-directory.
  51.     Copy all the SPObjects to "LIBS:spobjects/".
  52.  
  53.  
  54.     Correspondence :
  55.     ================
  56.  
  57.     If you like, you may send me some money. Perhaps this will motivate me
  58.     to continue programming such programs or just making updates of
  59.     this one. Send bug-reports, money or whatever to :
  60.  
  61.     Andreas R. Kleinert,
  62.     Grube Hohe Grethe 23,
  63.     D-57074 Siegen,
  64.     Germany.
  65.  
  66.     Phone:  +49-271-331859 (weekdays after 18.00h)
  67.             +49-271-332147 (weekdays after 18.00h)
  68.     EMail:  Fido             Andreas Kleinert 2:2457/435.10
  69.             Usenet/InterNet  Andreas_Kleinert@superview.ftn.sub.org
  70.  
  71.             If nothing else works, try one of these Fido-InterNet gateways:
  72.  
  73.             Andreas_Kleinert@p10.f435.n2457.z2.fido.sub.org (Germany)
  74.             Andreas_Kleinert@p10.f435.n2457.z2.fidonet.org  (US)
  75.  
  76.  
  77.     Support :
  78.     =========
  79.  
  80.     The following programs are currently supporting the "superplay.library" :
  81.  
  82.      - SuperPlay
  83.      - SimplePlay
  84.      - ...
  85.  
  86.  
  87.     SPObjects :
  88.     ===========
  89.  
  90.      SVObject     Type       Formats                          Write
  91.  
  92.      ST           Module     SoundTracker, ProTracker, ...    -
  93.      MED          Module     MMD0                             -
  94.      JAM          Modul      JamCracker V1.00+                -
  95.      8SVX         Sample     IFF-8SVX (unencoded)             Sample
  96.      VOC          Sample     PC VOC V1.10                     Sample
  97.      WAV          Sample     RIFF-WAVE (Windows)              Sample
  98.      SoundDT      Sample     OS3 Sound Datatypes              -
  99.  
  100.  
  101.     Planned SVObjects (no guarantee !) :
  102.  
  103.      - many...
  104.  
  105.  
  106.     Thanks and greetings to :
  107.     =========================
  108.  
  109.     in alphabetical order :)
  110.  
  111.     Alex    Carbin      (TuC / PowerBrei Red.),
  112.     Fred    Fish        (AmigaLibDisks),
  113.     Gerd    Frank       (BerndsPD),
  114.     Stefan  Grad        (GPD),
  115.     Stefan  Kremer      (TuC / PowerBrei Red.),
  116.     Alex    Lange       (Time PD-Serie),
  117.     H.P.    Lattka      (Franz PD-Serie),
  118.     Andreas Manewaldt   (Taifun PD-Serie),
  119.     Michael Petrikowski (Amiga Szene),
  120.  
  121.     and all I forgot !
  122.  
  123.  
  124.     History :
  125.     =========
  126.  
  127.      V4.3 (13.12.1994) :
  128.      -------------------
  129.       - added JamCracker support (JAM.spobject)
  130.       - added OS3 Sound DataTypes support (SoundDT.spobject).
  131.         Needs at least superplay.library V4.3, since
  132.         some additional work has to be done.
  133.       - fixed bug in ST sample extraction routine
  134.         (was only possible with XPK packed modules)
  135.       - fixed internal bug inside all SPObjects.
  136.  
  137.  
  138.      V4.2 (09.12.1994) :
  139.      -------------------
  140.       - file recognition did not work with V4.1.
  141.         (-> UNUSEABLE)
  142.  
  143.  
  144.      V4.1 (02.12.1994) :
  145.      -------------------
  146.       - adjusted some version descriptions in the Reference-Docs
  147.       - added new SPL_GetFileType() function, like in superview.library
  148.       - SPObject-Docfiles had been included twice in different directories
  149.         (old and new docs). Removed.
  150.         (-> Gerd Frank)
  151.  
  152.  
  153.      V3.1 (21.07.1994) :
  154.      -------------------
  155.       - This is not really a bug-fix, but more an additional feature :
  156.         increased Version to 3, because it was not save in V2.1 to pass
  157.         a NULL value for SuperWrite()'s "source_handle" parameter,
  158.         although this is supported by the V2 SPObjects (now).
  159.         If you plan to add this feature to your software, request at
  160.         least V3+ !
  161.  
  162.  
  163.      V2.1 (20.07.1994) :
  164.      -------------------
  165.  
  166.       - introduced "SampleLists" and added two new functions to superplay-
  167.         Library and Version 2 SPObjects for getting and setting of the
  168.         Lists. Added two Example-Programs which demonstrate usage of
  169.         SampleLists.
  170.       - re-arranged directory structure of most sub-dirs
  171.       - all NON-DISK loading and saving, e.g. from/into ClipBoard
  172.         DID NOT WORK.
  173.         Specifications had to be changed slightly - in a compatible way -
  174.         to re-arrange READING to work (see Reference-Docs,
  175.         SPL_InitHandleAsClip-Function).
  176.         For WRITING only superplay-Library had to be changed.
  177.         (This bug-fix has not yet been tested, since SuperPlay does not
  178.          support ClipBoard-Access, but it has been done the same way
  179.          as in superview.library, so it should work ...)
  180.       - ST.spobject and MED.spobject now allow extraction of Samples
  181.         of Modules
  182.         (see example-programs "SampleListDemo" and "SampleListPlay")
  183.       - fixed bad bug in ST.spobject's file-recognition (see there)
  184.  
  185.  
  186.      V1.6 (02.07.1994) :
  187.      -------------------
  188.  
  189.       - new version of SuperPlay (GUI improved)
  190.       - changes to ST.spobject and WAV.spobject
  191.       - added ".fd"-files to "Programmers/fd", which might be useful
  192.         for Basic programmers (".bmap" generation) or for generating
  193.         Link-Libraries
  194.       - last not least : I'm now reachable via EMail
  195.         (Fido : 2:2457/245.10)
  196.  
  197.  
  198.      V1.5 (17.05.1994) :
  199.      -------------------
  200.  
  201.       - use of SAS/C V6.51
  202.       - strongly improved ST.spobject
  203.  
  204.  
  205.      V1.4 (30.04.1994) :
  206.      -------------------
  207.  
  208.       - now WAV.spobject is really DEBUGGED and WORKS, which it
  209.         actually was not and did not before ;<
  210.       - also improved the other SPObjects a lot
  211.  
  212.  
  213.      V1.3 (30.3.1994) :
  214.      ------------------
  215.  
  216.       - added WAV.spobject to the distribution
  217.       - the new ST.spobject is now freely available as one of the supplied
  218.         Example-SPObjects
  219.       - improved Example-Programs : e.g. removed dependeny on ak_gen0.library
  220.       - removed some garbage from the header-files
  221.       - replaced SAS/C's sprintf()-routine with own, RawDoFmt()-based one.
  222.         This increases codesize a little bit, because sprintf() wasn't
  223.         actually used yet. This might come in the future.
  224.       - now using Utility-Library for integer operations (activated
  225.         SAS/C's UTILLIB option) : this increases 68000-codesize a little
  226.         bit, but increases speed on 68020+ systems
  227.         (should also decrease codesize, but does not ...)
  228.  
  229.  
  230.      V1.2 (27.2.1994) :
  231.      ------------------
  232.  
  233.       - recompilation : use of SAS/C V6.5.
  234.       - Parameter-BugFix in SVO_SetWriteSubType() :
  235.         pragmas put it into D1 instead of A2
  236.       - fixed small bug in the memory management routines
  237.  
  238.  
  239.      V1.1 :
  240.      ------
  241.  
  242.       - First Version. FREEWARE.
  243.  
  244.  
  245.     Copyrights :
  246.     ============
  247.  
  248.     Some of the mentioned names or products above may be copyrighted by
  249.     companies or trademarks of companies.
  250.  
  251.  
  252.     Remark: Drawericons have been taken from Fred Fish's AmigaLibDisks.
  253.